package com.nidu.demo.mail.gateway;

import com.alibaba.cola.dto.PageResponse;
import com.nidu.demo.mail.model.MailAccount;
import com.nidu.demo.mail.model.MailAccountCriteria;

import java.util.List;
import java.util.Set;

/**
 * 邮件账号网关接口
 * 供领域层调用，实现跨上下文/基础设施的邮件账号数据访问
 *
 * @author auto
 */
public interface MailAccountGateway {

    /**
     * 创建邮件账号
     *
     * @param mailAccount 邮件账号信息
     * @return 创建后的邮件账号
     */
    MailAccount create(MailAccount mailAccount);

    /**
     * 修改邮件账号
     *
     * @param mailAccount 邮件账号信息
     * @return 修改后的邮件账号
     */
    MailAccount update(MailAccount mailAccount);

    /**
     * 删除单个邮件账号
     *
     * @param id 邮件账号ID
     */
    void deleteById(Long id);

    /**
     * 批量删除邮件账号
     *
     * @param ids 邮件账号ID列表
     */
    void deleteByIds(Set<Long> ids);

    /**
     * 根据邮件账号ID查询
     *
     * @param id 邮件账号ID
     * @return 邮件账号信息
     */
    MailAccount getById(Long id);

    /**
     * 根据邮件账号ID列表查询
     *
     * @param ids 邮件账号ID列表
     * @return 邮件账号列表
     */
    List<MailAccount> getByIds(Set<Long> ids);

    /**
     * 根据邮箱地址查询
     *
     * @param mail 邮箱地址
     * @return 邮件账号信息
     */
    MailAccount getByMail(String mail);

    /**
     * 列表查询
     *
     * @param criteria 查询条件
     * @return 邮件账号列表
     */
    List<MailAccount> listByCondition(MailAccountCriteria criteria);

    /**
     * 分页查询
     *
     * @param criteria 查询条件
     * @return 分页结果
     */
    PageResponse<MailAccount> pageByCondition(MailAccountCriteria criteria);

    /**
     * 获取所有邮件账号
     *
     * @return 邮件账号列表
     */
    List<MailAccount> listAll();

}
